home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 31 / PC Actual CD 31.iso / dists / UPGRADE.TXT < prev   
Encoding:
Text File  |  1998-10-16  |  7.9 KB  |  169 lines
  1. +=====================  Upgrading  FreeBSD  ==========================+
  2. |                                                                     |
  3. | 0.0        Preface                                                  |
  4. |            0.1    DISCLAIMER                                        |
  5. |            0.2    IMPORTANT NOTE                                    |
  6. |                                                                     |
  7. | 1.0        Introduction                                             |
  8. |            1.1    Upgrade Overview                                  |
  9. |                                                                     |
  10. | 2.0        Procedure                                                |
  11. |            2.1    Backup                                            |
  12. |            2.2    Mount Filesystems                                 |
  13. |            2.3    Select Distributions                              |
  14. |            2.4    After Installation                                |
  15. |                                                                     |
  16. | 3.0        Alternative Upgrade Techniques                           |
  17. |                                                                     |
  18. +=====================================================================+
  19.  
  20. 0.1    DISCLAIMER
  21. ---    ----------
  22.  
  23. While the FreeBSD upgrade procedure does its best to safeguard against
  24. accidental loss of data, it is still more than possible to WIPE OUT YOUR
  25. ENTIRE DISK with this installation!  Please do not accept the final
  26. confirmation request unless you have adequately backed up any important
  27. data files.
  28.  
  29. 0.2    IMPORTANT NOTE
  30. ---    --------------
  31.  
  32. If you are upgrading from FreeBSD 2.2.5 or earlier, see
  33. section 2.4 for important details regarding changes to the
  34. /etc/fstab file required during the upgrade procedure.
  35.  
  36. 1.0    Introduction
  37. ---    ------------
  38.  
  39. The upgrade procedure replaces distributions selected by the user
  40. with those corresponding to the new FreeBSD release.  It preserves
  41. standard system configuration data, as well as user data, installed
  42. packages and other software.
  43.  
  44. Administrators contemplating an upgrade are encouraged to study this
  45. document in its entirety before commencing an upgrade.  Failure to do so 
  46. may result in a failed upgrade or loss of data.
  47.  
  48. 1.1    Upgrade Overview
  49. ---    ----------------
  50. Upgrading of a distribution is performed by extracting the new version of
  51. the component over the top of the previous version.  Files belonging to
  52. the old distribution are not deleted.
  53.  
  54. System configuration is preserved by retaining and restoring the
  55. previous version of the following files:
  56.  
  57.    Xaccel.ini, adduser.conf, aliases, aliases.db, amd.map, crontab,
  58.    csh.cshrc, csh.login, csh.logout, daily, disktab, dm.conf, exports, 
  59.    fbtab, fstab, ftpusers, gettytab, gnats, group, host.conf, hosts, 
  60.    hosts.equiv, hosts.lpd, inetd.conf, kerberosIV, localtime, login.access,
  61.    mail.rc, make.conf, manpath.config, master.passwd, mib.txt, modems,
  62.    monthly, motd, namedb, networks, passwd, phones, ppp, printcap, 
  63.    profile, protocols, pwd.db, rc, rc.firewall, rc.i386, rc.local, 
  64.    rc.network, rc.conf, remote, resolv.conf, rmt, security, sendmail.cf, 
  65.    services, shells, skeykeys, spwd.db, supfile, syslog.conf, termcap, 
  66.    ttys, uucp, weekly
  67.  
  68. The versions of these files which correspond to the new version are
  69. moved to /etc/upgrade/.  The system administrator may peruse these new
  70. versions and merge components as desired.  Note that many of these files 
  71. are interdependent, and the best merge procedure is to copy all
  72. site-specific data from the current files into the new.
  73.  
  74. During the upgrade procedure, the administrator is prompted for a
  75. location into which all files from /etc/ are saved.  In the event that
  76. local modifications have been made to other files, they may be
  77. subsequently retrieved from this location.
  78.  
  79. 2.0    Procedure
  80. ---    ---------
  81.  
  82. This section details the upgrade procedure.  Particular attention is
  83. given to items which substantially differ from a normal installation.
  84.  
  85. 2.1    Backup
  86. ---    ------
  87.  
  88. User data and system configuration should be backed up before
  89. upgrading.  While the upgrade procedure does its best to prevent
  90. accidental mistakes, it is possible to partially or completely destroy
  91. data and configuration information.
  92.  
  93. 2.2    Mount Filesystems
  94. ---    -----------------
  95.  
  96. The disklabel editor is entered with the nominated disk's filesystem
  97. devices listed.  Prior to commencing the upgrade, the administrator
  98. should make a note of the device names and corresponding mountpoints.
  99. These mountpoints should be entered here.  DO NOT set the 'newfs flag'
  100. for any filesystems, as this will cause data loss.
  101.  
  102. 2.3    Select Distributions
  103. ---    --------------------
  104.  
  105. When selecting distributions, there are no constraints on which must be
  106. selected.  As a general rule, the 'bin' distribution should be selected
  107. for an update, and the 'man' distribution if manpages are already
  108. installed.  Other distributions may be selected beyond those originally
  109. installed if the administrator wishes to add additional functionality.
  110.  
  111. 2.4    After Installation
  112. ---    ------------------
  113.  
  114. Once the installation procedure has completed, the administrator is
  115. prompted to examine the new configuration files.  At this point, checks
  116. should be made to ensure that the system configuration is valid.  In
  117. particular, the /etc/rc.conf and /etc/fstab files should be checked.
  118.  
  119. Read the following, but DO NOT update /etc/fstab as described below
  120. until the new system has booted correctly.  The upgrade procedure
  121. replaces the previous FreeBSD kernel with a GENERIC kernel, and a custom
  122. kernel may need to be generated to suit the local system configuration.
  123.  
  124. IMPORTANT NOTE:
  125. ==============
  126. FreeBSD 2.2.6 introduced a change in the naming of the device from 
  127. which the root filesystem is mounted.  This change affects all systems, 
  128. however user intervention is only required for systems undergoing an 
  129. upgrade installation from a version prior to FreeBSD 2.2.6.
  130.  
  131. Previously, the root filesystem was always mounted from the
  132. compatibility slice, while other partitions on the same disk were
  133. mounted from their true slice.  This might, for example, have resulted 
  134. in an /etc/fstab file like:
  135.  
  136. # Device      Mountpoint      FStype  Options         Dump    Pass#
  137. /dev/wd0s2b   none            swap    sw              0       0
  138. /dev/wd0a     /               ufs     rw              1       1
  139. /dev/wd0s2f   /local0         ufs     rw              1       1
  140. /dev/wd0s2e   /usr            ufs     rw              1       1
  141.  
  142. For FreeBSD 2.2.6 and later, this format changes so that the device for 
  143. '/' is consistent with others, ie.
  144.  
  145. # Device      Mountpoint      FStype  Options         Dump    Pass#
  146. /dev/wd0s2b   none            swap    sw              0       0
  147. /dev/wd0s2a   /               ufs     rw              1       1
  148. /dev/wd0s2f   /local0         ufs     rw              1       1
  149. /dev/wd0s2e   /usr            ufs     rw              1       1
  150.  
  151.  
  152. If /etc/fstab is not updated manually in this case, the system will
  153. issue a warning message whenever / is mounted (normally at startup)
  154. indicating the change that must be made.  In addition, trouble may be
  155. experienced if the root filesystem is not correctly unmounted, whereby
  156. the root filesystem will not be marked clean at the next reboot.
  157.  
  158. This change should be made as soon as the upgraded system has been
  159. successfully rebooted.
  160.  
  161. 3.0    Alternative Upgrade Techniques
  162. ---    ------------------------------
  163.  
  164. Those interested in an upgrade method that allows more flexibility and
  165. sophistication should take a look at the "Upgrading FreeBSD from source"
  166. tutorial found at http://www.freebsd.org/docs.html.  This method
  167. requires reliable network connectivity, extra disk space and spare time,
  168. but has advantages for networks and other more complex installations.
  169.